home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbbsdocs.zip / RBBSDOCS.13 < prev    next >
Text File  |  1990-11-05  |  6KB  |  111 lines
  1.  
  2.  
  3.  
  4.     SETTING UP ".BAT" FILES FOR RBBS-PC                                    13-1
  5.  
  6.  
  7.     13. SETTING UP ".BAT" FILES FOR RBBS-PC
  8.     ---------------------------------------
  9.     In order for you to take  advantage of all RBBS-PC functions, you  must run
  10.     RBBS-PC  via a  .BAT file.   When  processing events  such as  DOORS, daily
  11.     maintenance and  Remote DOS access, RBBS-PC  exits to DOS, and  expects the
  12.     .BAT file that invoked it to handle these events.
  13.  
  14.     13.1 RBBS-PC's Startup Batch File
  15.     ---------------------------------
  16.     The batch  file (RBBS.BAT) that comes  with RBBS-PC is capable  of handling
  17.     these events, but in order to make  full use of it, you must understand the
  18.     commands  in it.   RBBS-PC  stores the  name of this  batch file  in CONFIG
  19.     parameter 104.   This  example assumes you  have installed  RBBS-PC in  the
  20.     directory C:\RBBS.  Each line in the .BAT file is described below:
  21.  
  22.     COMMAND        DESCRIPTION
  23.     ECHO OFF       This tells DOS not to display each command as it executes.
  24.  
  25.     CLS            This clears the screen.
  26.  
  27.     C:             This  makes sure  that when  you start RBBS-PC,  the default
  28.                    drive is the one where RBBS-PC resides.
  29.  
  30.     IF %node%. == . SET node=1
  31.                    You should remove this  line from RBBS.BAT, and place  it in
  32.                    the  AUTOEXEC.BAT  for each  node.   Of  course,  change the
  33.                    number   to  correspond   to   the  node   number  in   each
  34.                    AUTOEXEC.BAT.     This  function   makes  use  of   the  DOS
  35.                    "environment variable"  concept.  From now on,  when you see
  36.                    %node%, substitute the node number.
  37.  
  38.     :START         This is a  "branch label" which  allows RBBS.BAT to  recycle
  39.                    continuously.
  40.  
  41.     CD C:\RBBS     This line  makes  sure  that when  you  start  RBBS-PC,  the
  42.                    default subdirectory is the one where RBBS-PC resides.
  43.  
  44.     IF EXIST C:\RBBS\NODE%node%\RBBS%node%TM.DEF ...
  45.           DEL C:\RBBS\NODE%node%\RBBS%node%TM.DEF
  46.                    This command  checks for  the DAILY  EVENT signal  file, and
  47.                    deletes it.  This  is a "cleanup" command, which  makes sure
  48.                    there are no old signal files on the disk.
  49.  
  50.     IF EXIST C:\RBBS\NODE%node%\RBBS%node%F1.DEF ...
  51.           DEL C:\RBBS\NODE%node%\RBBS%node%F1.DEF
  52.                    This command  checks  for the  SysOp EXIT  signal file,  and
  53.                    deletes it.  This is a another "cleanup" command.
  54.  
  55.     IF EXIST C:\RBBS\NODE%node%\RCTTY.BAT ...
  56.           DEL C:\RBBS\NODE%node%\RCTTY.BAT
  57.                    This command  checks for the  DOOR signal file,  and deletes
  58.                    it.   This  is a  another "cleanup" command.   The  path and
  59.                    filename  of  this  signal  file  can  be  set  with  CONFIG
  60.                    parameter 103.
  61.  
  62.     RBBS-PC %1     This  command actually runs RBBS-PC.   The %1  allows you to
  63.                    specify  options when  you  use  the  RBBS.BAT  file.    For
  64.                    example, if you enter "RBBS LOCAL", the "LOCAL" is passed to
  65.                    RBBS-PC, so you can run in local mode.
  66.  
  67.  
  68.  
  69.     RBBS-PC 17.3A            TECHNICAL REFERENCE MANUAL                    13-2
  70.  
  71.  
  72.     IF EXIST C:\RBBS\NODE%node%\RBBS%node%F1.DEF GOTO EXIT
  73.                    This command checks for  the SysOp EXIT signal file,  and if
  74.                    found, exits the .BAT file.   The SysOp EXIT signal  file is
  75.                    created whenever the SysOp presses F1 at the local console.
  76.  
  77.     IF EXIST C:\RBBS\NODE%node%\RBBS%node%TM.DEF RBBSTIME.BAT
  78.                    This  command checks for the DAILY EVENT signal file, and if
  79.                    found, runs the .BAT file RBBSTIME.BAT.  The daily event can
  80.                    contain  any maintenance  you  wish to  perform  on a  daily
  81.                    basis.  RBBS-PC will create the DAILY EVENT signal file at a
  82.                    the time specified in CONFIG parameter 261.
  83.  
  84.     IF EXIST C:\RBBS\NODE%node%\RCTTY.BAT C:\RBBS\NODE%node%\RCTTY.BAT
  85.                    This  command checks for the DOOR signal file, and if found,
  86.                    executes it.  The  DOOR signal file is created when a caller
  87.                    opens a DOOR, or the SysOp requests remote DOS operation.
  88.  
  89.     GOTO START     This command restarts RBBS-PC during  a "recycle."  The only
  90.                    way to stop RBBS-PC completely is to press F1.
  91.  
  92.     :EXIT          This is a  "branch label."   When RBBS.BAT  finds the  SysOp
  93.                    EXIT signal file,  it branches here, which  ends RBBS-PC and
  94.                    returns to DOS.
  95.  
  96.     For multi-node use, the command "RBBS-PC %1" must be changed to indicate to
  97.     RBBS-PC that you are running multiple nodes.  The revised command would be:
  98.  
  99.     RBBS-PC %node% RBBS%node%PC.DEF %1
  100.  
  101.     13.2 The Daily Event .BAT file
  102.     ------------------------------
  103.     CONFIG  option 261 allows you to specify a  time each day that RBBS-PC will
  104.     exit for daily  maintenance.  The  supplied RBBS.BAT  file can detect  this
  105.     event  (via the  RBBS?TM.DEF signal  file) and  process a  .BAT file.   The
  106.     contents  of the daily  event file can  contain whatever the  SysOp wishes:
  107.     Tape backup commands, message packing, file verification or virus checking.
  108.     Just make  sure that the daily event file re-invokes the RBBS.BAT file when
  109.     processing is complete, and RBBS-PC will resume after the maintenance.
  110.  
  111.